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About This Manual 


Purpose of this Manual 


This manual describes the programming and use of SQL C-J DBC, which is an 
interface that enables you to use] ava J DBC classes to create applications that connect 
with soL Connector Data Sources. These applications can run on NetWare or 
Windows platforms, since J ava is supported on both platforms. The soL Connector 
Data Source is used to maintain and manage a reference list of physical databases and 
tables. These database table references are stored in the Data Source, and used by SQL 
C-J DBC to connect applications to these databases. 


This manual provides descriptions and examples that are, as nearly as possible, 
generic for all databases supported by soL Connector. Unless stated as an exception, 
SQL statements and procedures developed with the material in this document will be 
portable across all supported databases, regardless of the specific SQL requirements of 
the database. 


Intended Audience 


This document is intended for programmers who will be creating and maintaining 
applications which use soL C-J DBC to connect to physical databases. It provides 
details on creating J DBC URL's, summarizes J DBC API usage, and provides 
information on how the J DBC functions and SQL grammar map to 

SQL C-J DBC features. 


This document assumes that programmers are familiar with the] DBC Application 
Programming Interface (API). For information about the] DBC API, you can 
download information using http://java.sun.com/products/jdbc/index.html. 





Structure of this Manual 


This manual consists of chapters which describes how to configure and use soL C- 
J DBC. 


Associated Documents 


The soL Connector document set contains these manuals: 
* soL Connector Overview 
* soL Connector Installation Guide 
e soL Connector Administration Guide 
e soL Connector SQL Grammar Manual 
e soL Connector ODBC Programmer's Guide 
* soL Connector | DBC Programmer's Guide 
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Operating System Conventions 


When there are differences in commands, examples, or syntax between operating 
systems, the following abbreviations are used: 


Abbreviation Meaning 
NetWare the Novell NetWare operating system 
Windows the Microsoft Windows 95/98/NT operating systems 
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Overview 





1.1 Introduction 


SQL Connector is a Data Request Broker for database access. It provides the capability 
of using standard Structured Query Language (SQL) to access data in tables in 
different databases. Thetables are cataloged in an soL Connector Data Source, which 
can then be accessed by client applications using the] ava Database Connectivity 

(J DBC) interface. 


The sat Connector Data Source is created and maintained by the Data Source 
Administrator and documented in the Administration Guide. 


1.2 Architecture 


J ava applications can access the soL C-DRB (Data Request Broker) from any system 
that supports the J ava environment. The client application uses J ava SQL C-] DBC 
classes to connect to soL C-DRB running on a network server. SQL C-DRB uses an 
SQL Connector Data Source to connect to Oracle on the network server or to remote 
ODBC databases using the soL Connector ODBC Data Driver. 


1.2.1 JDBC Driver Client Configuration 


A J ava client application uses the following soL C-J DBC classes and layers to connect 
to the soL Connector network server and the soL Connector Data Driver: 


e Programming Layer 





java.sql.* prototype JDBC API (JDK version 1.1) 
sqli.sql.* so C-JDBC implementation of JDBC API 





e System Layer 





vortex.* so C-JDBC socket classes 
java.net.* Java socket services 
classes.zip Java runtime environment (with socket services) 


1.2.2 Data Request Broker Configuration 


The system runtime environment uses TCP/IP network sockets to communicate with 
the server. The server executes a program which listens for incoming requests on a 
specified TCP/IP socket. 


e System Layer 

network listener module vtxnetd.nlm, vtx16.nlm 
e Connection Layer 

SQLC host module sqlcmon.nlm, sqlc.nlm 
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Data Source local and remote databases 


The sou Connector network listener runs on the Data Broker system (typically from 
the time the Data Broker system is booted). The listener responds to requests from a 
specified TCP/IP socket. When it receives a network request from the client, it creates 
a client thread (if one is not already created), which then changes the network request 
into a database request and calls the soL Connector Data Broker engine. The Data 
Broker engine uses the Data Source to access physical databases or local files. 


1.2.3 Database Drivers Configuration 


ThesaL Connector Data Drivers are used to connect the Data Source to local and 
remote databases. Remote connectivity is discussed in the Administration Guide 


1.3 JDBC Interface 


J DBC (J ava Database Connectivity) is an industry-standard API (application 
programming interface) for connecting client applications and data servers. For more 
information about the] DBC API, see http://java.sun.com/products/jdbc/index.html. 


The] DBC API documentation specifies the names and arguments of functions which 
define the interface between the] ava client application and the data source. However, 
within the documentation, there are levels of conformance tothe] DBC standard, and 
there are sections of the standard which allow vendor-defined features (for example, 
datatypes and error messages). The purpose of this manual is to discuss the 
implementation and programming of soL C-] DBC as it relates to the} DBC standard. 


For a discussion of the SQL grammar supported by soL Connector, see the SQL 
Grammar Manual. 





Installation of soL C-] DBC is discussed in the Installation Guide and creation and 
maintenance of a Data Source is discussed in the Administration Guide The 
remainder of this document assumes that soL C-] DBC has been successfully installed 
and a Data Source is available for use. 


1.4 JDBC Classpath 


1.4.1 Windows 


The Windows cLasspatu system variable must be updated to include the path to the 
SQL C-] DBC J ava classes. For Windows 95/98, the file c: \AUTOEXEC.BAT must be 
edited. For example, if the sou C-J DBC classes have been installed on the directory 
c:\so1c, then the following command can be used to update the CLASSPATH system 
variable: 








SET CLASSPATH = C:\SQLC\SQLCJDBC.JAR; SCLASSPATHS 


For Windows NT, the cLasspatH environment variable can be set using Control Panel 
> System > Environment. 
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1.4.2 NetWare 


The NetWare cLasspatu system variable must be updated to include the path to the 
SQL C-] DBC J ava classes. For Netware, the cLasspats is defined in the file 
SYS:ETC\JAVA.CFG. The SQLCUDBC. JAR should be copied to the directory 

SYS: JAVA\CLASSES, then the Java. crc file should be edited. A sample sava.cre with 
an added line is shown below: 








JAVA_HOME=SYS : \JAVA 

OSA_HOME=SYS : \JAVA 

MGMT_HOME=SYS : \PUBLIC\MGMT 
LASSPATH=sys:\java\lib\classes.zip;sys:\java\classes;. 
LASSPATH=SCLASSPATH; S$OSA_HOME\lib\swing. jar 
LASSPATH=SCLASSPATH; S$OSA_HOME\lib\jg13.1.0.jar 
LASSPATH=SCLASSPATH; $OSA_HOME\1ib\help. jar 
LASSPATH=SCLASSPATH; S$OSA_HOME\lib\servertop. jar 
LASSPATH=SCLASSPATH; $OSA_HOME\lib\jndi.jar 
LASSPATH=SCLASSPATH; $OSA_HOME\lib\njcl. jar 
LASSPATH=SCLASSPATH; $OSA_HOME\lib\vbjorb. jar 
LASSPATH=SCLASSPATH; SOSA_HOME\lib\vbjapp. jar 
LASSPATH=$CLASSPATH; SOSA_HOME\lib\vbjtools.jar 
LASSPATH=SCLASSPATH; SOSA_HOME\lib\ucs. jar 
LASSPATH=SCLASSPATH; $OSA_HOMEN 
LASSPATH=$CLASSPATH; SOSA_HOME\beans\NWDir. jar 

LASSPATH=$CLASSPATH; SOSA_HOME\beans\NWSess. jar 
LASSPATH=$CLASSPATH; SOSA_HOME\beans\NWPrtQAdm. jar 
LASSPATH=$CLASSPATH; SOSA_HOME\beans\NWSockets. jar 
LASSPATH=$CLASSPATH; SOSA_HOME\classes\SQLCJDBC.JAR <-- added line 


After the file is edited, the NetWare] ava Virtual Machine must be restarted. At the 
NetWare console, type: 











ocecacececaccocoacocdo 





























java -exit 
java 


The CLASSPATH can be examined using the following command: 
envset classpath 
The output will be similar to: 


classpath=sys:\java\lib\classes.zip;sys:\java\classes;.;SYS:\JAVA\lib\ 
swing. jar; SYS: \JAVA\lib\jg13.1.0.jar;SYS:\JAVA\lib\help. jar; SYS:\JAVA\lib 
\servertop. jar;SYS:\JAVA\lib\jndi.jar;SYS:\JAVA\lib\njcl.jar;SYS:\JAVA\ 
lib\vbjorb. jar;SYS:\JAVA\lib\vbjapp. jar; SYS: \JAVA\lib\vbjtools.jar;SYS:\ 
JAVA\lib\ucs. jar; SYS: \JAVA\;SYS:\JAVA\beans\NWDir. jar; SYS: \JAVA\beans\ 
NWSess. jar; SYS: \JAVA\beans\NWPrtQAdm. jar; SYS: \JAVA\beans\NWSockets. jar; 
SYS: \JAVA\classes\SQLCJDBC.JAR 


The output confirms the location of the jar file. 
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2 
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Data Source Setup and Connection 





2.1 Introduction 


This chapter discusses creating and configuring an soL Connector J DBC database 
connection on a client system. An SQL Connector (soL C) J DBC connection is a] DBC 
connection to an soL Connector Data Request Broker (DRB) and a Data Source on a 
network server. An soL C-J DBC connection requires the name of the Data Source, 
the name of the server that is running the Data Request Broker and the network 
protocol used to access the server. Oncethe soL C-J DBC driver is loaded and an sQL 
C-J DBC connection is created, a J DBC application can connect to an SQL Connector 
Data Source using the standard J DBC API. 


2.2 JDBC Driver Loading 


The soL C-J DBC installation procedure installs the soL C-J DBC driver and related 
software. The directory which contains thesoL C-] DBC jar file (sqicjdbc. jar) must 
be included in the cLasspatu system variable. 


The name of the soL C-] DBC driver is sqli.sql.sqliDriver. To load the soL C- 
J DBC driver in aJ ava program, use the following (or similar) syntax: 
import java.sql.* 


Driver d = (Driver) Class.forName ("sqli.sql.sqliDriver") .newInstance() ; 


2.3 JDBC Driver Connection 


After the sq_ C-J DBC driver is loaded, an SQL Connector connection can be completed 
by using the following (or similar) J ava syntax: 


String url = jdbc:sqli:<Net URL, see discussion below>; 
String uid = <username>; 
String pwd = <password>; 


Connection c = DriverManager.getConnection (url, uid, pwd); 


Uniform Resource Locator (URL) Connection String 


The URL is a string for the network connection, which is in the following format 
(symbol "1" indicates option, symbol "|" indicates choice): 


jdbe:sqli://[usere@ | :passworde | user:password@] host :port /datasource 





[;environs=switches | 





username - optional 
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The name of the user for the network connection, followed by "e" if the password is 
omitted. If the username is not included in the URL, it must be supplied as the second 
argument of DriverManager.getConnection (url, uid, pwd), Or supplied in the 
connection properties list for DriverManager.getConnection(url,prop). 


password - optional 


The password of the user for the network connection, preceded by ":" and followed by 
"a". If the password is not included in the URL, it must be supplied as the third 
argument of DriverManager.getConnection (url, uid, pwd), or supplied in the driver 
connection properties list when DriverManager .getConnection (url, prop) is used. 


host - required 
The name of the server or internet address (format nnn.nnn.nnn.nnn) which is 
running SQL C-DRB. The name must be in the system hosts file. 


Windows host file: 
c:\winnt\system32\drivers\etc\hosts 


port - required 


A port number used by TCP/IP socket services, preceded by a ":". This number must 
match a number used when the soL Connector listener is started on the server. 


datasource 
The name of the Data Source (no spaces). 


Sample Data Source name: 
demo 


Note: A sample Data Source can be created using data files included in the software 
distribution directory. See the Administration Guide for details. 


environs 


SQL Connector switch values or environment variables. For a full description, see the 
SQL Grammar Manual. The format is: namel=valuel, name2=value2,... 





Example 
An example of a complete URL is shown below: 


jdbc:sqli://user:pass@server1:1958/demo; 
environs=SS_TRACE=yes, SMARTTRACE=sql.trc 








Example Notes: 
1. TheData Source is named demo. 
2. TCP/IP port 1958 is used on node server1 
3. There are two switches used in this example: 
a. SS TRACE =yes 
This switch turns on database tracing. All activity with local and remote 


databases will be written to a trace file. This trace fileis useful for debugging and 
optimizing database applications. 


b. SMARTTRACE =sal.tre 
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This switch names the trace file. If the name is not set, a default name will be 
used. The default name is s<year-day-number><hour-minute>.tre, for example, 
s0411634.trc, and the default directory is the location of the loaded programs. 


Other Data Source switch variables are discussed in the SQL Grammar Manual. 


2.4 Testing a JDBC Data Source Connection 


2.4.1 


Sample Programs 


The NetWare PUBLIC directory contains a Samples subdirectory that has two programs 
for testing an SQL C-J DBC Data Source connection using two and three tiers. One 
program (jdbcping) verifies the installation by connecting from a client system (first 
tier) toa Data Source on a network server (second tier) and reporting success or 
failure. The other program (jdbcjoin) connects from a client (first tier) toa Data 
Source on a network server (second tier) and retrieves joined data using a remote 
ODBC Data Driver on a database server (third tier). Both programs are supplied in 
source form (java code) and compiled classes (class files). The source code is listed in 
Appendices D and E. 


The following programs can be copied from the Netware PUBLIC directory toa 
Windows client system (i.e, the system that will run the sample programs). The file 
locations are: 


SYS: PUBLIC\SQLC\samples\windows\jdbc\ jdbcjoin. java 
SYS: PUBLIC\SQLC\samples\windows\jdbc\jdbcjoin.class 
SYS: PUBLIC\SQLC\samples\windows\jdbc\ jdbcping. java 
SYS: PUBLIC\SQLC\samples\windows\jdbc\jdbcping.class 


2.4.2 Sample Data 


Warning: 


A sample database with sample tables is also supplied. The sample data source is a 
Microsoft Access file that contains tables for departments (dept), jobs (job), employees 
(emp) and salaries (sal). This sample database must be copied to a Windows remote 
system that has the ODBC Data Driver installed. The file location is: 


SYS: PUBLIC\SQLC\samples\windows\access\demo.mdb 
Once the file is copied, the following steps should be performed: 


1. On the database server (third tier), create an ODBC Data Source Name "demo" 
that uses the Microsoft Access ODBC driver and the database file demo.mdb. 


2. RuntheData Source Administrator and create a Data Source named "demo" on the 
network server (second tier) that points tothe ODBC Access data source "demo" on 
the database server (third tier). See the Administration Guide for details about 
this step. 


If the Access database is on a NetWare mounted drive, then the NetWare login 
and the Windows NT login must be the same username. 


The Access database is now available for use with the sample programs. 
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2.4.3 Using jdbcping to Verify a Connection 


The jdbcping program can be executed in an MS-DOS command window or at a 
NetWare console. A J ava runtime environment must be installed, and the files 
jdbcping.class and sqlcjdbc. jar must be in the cLAssPATH as discussed above for 
Windows or NetWare. 


The program jdbcping is used as follows: 
Usage: java jdbcping <url> <username> <password> 
Example: java jdbcping jdbc:sqli://@server1:1958 - 

/demo myuser mypass 
If the J DBC connection is established, this message is displayed: 


Successful Connection 


An alternate form of usage is to include the username and password in the URL: 
Usage: java jdbcping <url> ™ "" 








Example: java jdbcping jdbc:sqli://myuser:mypass@server1:1958 - 
/demo wee wee 


2.4.4 Using jdbcjoin to Retrieve Data 


After a connection has been verified, the sample data may be retrieved using the 
jdbcjoin program, which also must be in the cLasspatu for Windows or NetWare. 
The jdbcjoin program is used as follows: 

Usage: java jdbcjoin <url> <username> <password> 

Example: java jdbcjoin jdbc:sqli://@server1:1958 - 

/demo myuser mypass 


An alternate form of usage is to include the username and password in the URL: 
Usage: java jdbcjoin <url> "" "" 





Example: java jdbcjoin jdbc:sqli://myuser:mypass@server1:1958 - 
/demo wee wee 


If the data is successfully retrieved, the following text is displayed: 









































































































































select 
dept.deptno, dept.dname, emp.empno, emp.ename, emp.ssno, emp.jobcls 
from 
dept, emp 
where 
dept.deptno = emp.deptno and dept.deptno < 3 
Dept.Deptno Dept.Dname Emp.Empno Emp.Ename Emp .SSNO Emp .JobCls 
MARKETING 20265 BASINGER_R 394-90-3583 2 
MARKETING 20337 GILBREATH_R 553-40-5418 5 
MARKETING 20365 MILLER_R 248-95-1471 6 
MARKETING 32024 GOVE_T 742-35-6859 4 
MARKETING 33297 ELLISON_W 252-60-1283 2 
MARKETING 33733 BANFIELD_S 688-21-4136 4 
MARKETING 33771 NASER_K 848-17-0910 8 
MARKETING 34410 MCCORRY_K 015-84-9007 7 
MARKETING 35844 MCCARTNEY_H 211-02-7599 7 
MARKETING 35909 LACY_C 494-12-0675 7 
MARKETING 38342 KINGSLEY_S 107-42-3232 5 
MARKETING 39748 BARNETT_N 179-22-5607 4 
MARKETING 63297 ELLISON_V 152-60-1283 1 
MARKETING 63647 HAWTHORNE_A 735-64-9259 3 
MARKETING 63910 BRANNEN_P 355-008-2564 3 
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1 MARKETING 64689 FULFORD_W 546-61-8895 5 
1 MARKETING 67528 BLOCK_F 084-40-0022 3 
1 MARKETING 68355 SWIFT_E 358-51-5799 9 
2 TRAINING 20384 KNAPP_L 381-26-6148 3 
2 TRAINING 31028 ROCHE_D 671-74-2192 9 
2 TRAINING 32482 NICHOLL_F 129-79-0929 8 
2 TRAINING 34948 LINGTON_ 686-40-9928 4 
2 TRAINING 35038 ROMANN_H 079-54-8297 9 
2 TRAINING 39208 DER_N 460-95-5451 2 
2 TRAINING 64948 LINGTON_ 586-40-9928 3 
2 TRAINING 68551 HOLMES_P 664-23-5820 3 
2 TRAINING 69208 DER_M 360-95-5451 1 
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J DBC Implementation 





3.1 Introduction 


The] DBC API specifies a level of functionality that must be provided by a J DBC 
driver in order to connect to] DBC applications. This level applies to a set of classes 
and methods and a set of datatypes. 


There is a set of J DBC driver and connection methods that allow a J DBC application 
to discover the functionality available from the] DBC driver. The] DBC application 
then knows the limits of the driver and does not try to exceed the limits. The results 
of these methods for the sa. C-J DBC are documented in Appendix A. A complete 
discussion of the driver and connection methods can be found by browsing the 
documentation at http: //java.sun.com/products/jdbc/index.html. 





3.2 SQL Grammar 


SQL Connector supports most all of the elements in the minimum SQL grammar, and 
some elements of the core and extended SQL grammar. For a complete discussion of 
SQL grammar elements, see Appendix C in the Microsoft ODBC 2.0 Programmer's 
Referenceand SDK Guide 


Core elements not supported are Data Definition Language (DDL) statements (CREATE 
and DROP TABLE, CREATE and DROP INDEX). SQL Connector uses database table and 
column information that is imported from existing physical databases. Tables and 
indexes are first created in the physical database using the appropriate database tools, 
then imported intosoL Connector. 





The SQL Grammar elements are categorized as follows: 
1. Minimum SQL grammar elements: 


e Data Manipulation Language (DML): simple SELECT, INSERT, UPDATE and 
DELETE 



































e Expressions: simple, such as a > B + c 
e Datatype: CHAR 
2. Core SQL grammar elements: 
e Minimum SQL grammar and data types 
e DML: full SELECT 
e Expressions: subquery and aggregates such as sum and MIN 
e Datatypes: DECIMAL, SMALLINT, FLOAT, REAL, DOUBLE 
3. Extended SQL grammar 
e Minimum and Core SQL grammar and data types 


e Expressions: scalar functions such as sSUBSTRING and date, time, and 
timestamp literals 


e Datatypes: DATE, TIME, TIMESTAMP 



































JDBC Implementation J-14 


SQL Connector J DBC Programmer's Guide 








3.3 SQL Datatypes 
SQL C-] DBC supports the following SQL data types: 












































soL Connector Maximum Case 
Datatype J ava Type Column Size | Nullable | Sensitive | Searchable 
char String 32000 Y Y Y 
varchar String 32000 Y Y Y 
decimal java.math.BigDecimal 19 Y N Y 
tinyint byte 3 Y N Y 
smallint short 5 Y N Y 
integer int 10 Y N Y 
bigint long 19 Y N Y 
real float 7 Y N Y 
double double 16 Y N Y 
date date Le Y N Y 
timestamp timestamp a Y N Y 
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A 
Driver and Connection Attributes 


Thefollowing table lists the information type and values that are returned by Driver 
and Connection MetaData functions. A complete discussion of the driver and 
connection methods can be found by browsing the documentation at 
http://java.sun.com/products/jdbc/index.html. 








Information Type 


Information Value 








Driver Information 




















acceptsU RL jdbc:sali 
getClass.getN ame sqli.sql.sqliDriver 
getM ajorVersion 1 

getMinor Version 0 

jdbcCompliant false 

Driver Property[0].name service 





SQL Connector Server program 





[ 
Driver Property[0].description 
Driver Property[0].value 


vtx16 
































Driver Property[0].required false 
Driver Property[0].choices null 
Driver Property[1].name fetch size 
Driver Property[1].description Fetch buffer size 
Driver Property[1].value 8192 
Driver Property[1].required: false 
Driver Property[1].choices null 
Connection Information 
getAutoCommit true 
isReadOnly false 





getT ransactionl solation (default) 


TRANSACTION REPEATABLE READ 





MetaData Information 















































allProceduresAreCallable false 
allTablesAreSelectable true 
dataDefinitionCausesT ransactionCommit false 

doesM axRowSizel ncludeBl obs true 
getCatalogSeparator null 
getCatalogT erm null 
getDatabaseP roductN ame SQL Connector 
getDatabaseP roductV ersi on 3.1 

getDefaultT ransactionl solation 4 

getDriverM ajorVersion 2 
getDriverMinorVersion 3 
getDriverName sqli.sal.sali Driver 
getDriverVersion 2.3 
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Information Type 


Information Value 







































































getE xtraNameCharacters null 
get! dentifierQuoteString i 
getMaxBinaryLiteralLength 0 
getM axCatalogN ameL ength 0 
getM axCharLiteralL ength 32767 
getM axColumnN amelL ength 31 
getM axColumnsl nGroupBy 8 
getM axColumnsl ni ndex 8 
getM axColumnsl nOrderBy 8 
getM axColumnsinSelect 1023 
getM axColumnsInT able 1023 
getM axConnections 0 
getM axCursorN ameL ength 0 
getM axl ndexL ength 120 
getM axProcedureN ameL ength 0 
getM axRowSize 8192 
getM axSchemaN ameL ength 31 
getM axStatementL ength 32767 
getM axStatements 128 
getM axT ableN ameL ength 31 
getM axT ablesinSelect 30 
getM axU serNameLength 0 





getNumericF unctions 


ABS,INT2,INT4,F LOAT4,F LOAT8,MOD,ACOS, 
ASIN,ATAN,COS,COT,DEGREES,EXP,LOG, 
LOG10,MOD,PI,POWER,RADIANS,RAND, 
ROUND,SIGN,SIN,SQRT,TAN, TRUNCATE 











getP rocedureT erm null 
getSQL Keywords <see Appendix B > 
getSchemaTerm schema 





getSearchStringE scape 


\ 





getStringF unctions 


CONCAT, STRING, SUBSTRING, TO_CHAR, 
ASCII, CHAR, INSERT, LCASE, LEFT, 
LENGTH,LOCATE, LTRIM, REPEAT, 
REPLACE, RIGHT, RTRIM, SPACE, UCASE 





getSystemF unctions 


NVL,ISNULL,IFNULL, DATABASE, USER 





getT imeDateF unctions 


TO_DATE, CURDATE, CURTIME, DAYNAME, 
DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, 
HOUR, MINUTE, MONTH, MONTHNAME, 
NOW, QUARTER, SECOND, TIMESTAMPADD, 
TIMESTAMPDIFF, WEEK, YEAR 


























getU serN ame <username> 
isCatalogAtStart true 
isReadOnly false 
nullPlusNonNullisNull true 
nullsAreSortedAtE nd false 
nullsAreSortedAtStart false 
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Information Type 


Information Value 












































































































































nullsAreSortedHigh true 
nullsAreSortedL ow false 
storesL owerCasel dentifiers true 
stor esL ower CaseQuotedl dentifiers true 
storesM ixedCasel dentifiers false 
storesMixedCaseQuotedi dentifiers false 
storesU pperCasel dentifiers false 
storesU pperCaseQuotedl dentifiers false 
supportsANSI92EntryL evelSQL true 
supportsANSI92F ullSQL true 
supportsAN SI 921 ntermediatesQL true 
supportsAlterT ableWithAddColumn false 
supportsAlterT ableWithDropColumn false 
supportsCatalogsinDataM anipulation false 
supportsCatalogsl nl ndexDefinitions false 
supportsCatalogsl nPrivilegeDefinitions false 
supportsCatalogsl nP rocedureCalls false 
supportsCatalogsl nT ableDefinitions false 
supportsColumnAliasing false 
supportsConvert false 
supportsCoreSQL Grammar true 
supportsCorrelatedSubqueries true 
supportsDataDefinitionAnd true 
DataM anipulationT ransactions 

supportsDataM anipulationT ransactionsOnly |false 
supportsDifferentT abl eCorrelationN ames false 
supportsE xpressionsl nOrderBy true 
supportsE xtendedSQL Grammar true 
supportsF ullOuter] oins true 
supportsGroupB y true 
supportsGroupB yBeyondSelect false 
supportsGroupB yU nrelated true 
supportsl ntegrityE nhancementF adlity false 
supportsLikeE scapeClause true 
supportsLimitedOuter] oins true 
supportsM inimumSQL Grammar true 
supportsM ixedCasel dentifiers true 
supportsMixedCaseQuotedi dentifiers false 
supportsM ultipleR esultSets false 
supportsM ultipleT ransactions true 
supportsN onNullableColumns true 
supportsO penCursorsAcrossCommit false 
supportsOpenCursorsAcrossRollback false 
supportsOpenStatementsAcrossCommit true 
supportsOpenStatementsAcrossRoll back true 
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Information Type 


Information Value 

























































































supportsOrderByUnrelated true 
supportsOuter] oins true 
supportsP ositionedDelete false 
supportsP ositionedU pdate false 
supportsSchemasl nDataM anipulation true 
supportsSchemasl nl ndexDefinitions true 
supportsSchemasl nPrivilegeDefinitions false 
supportsSchemasl nProcedureCalls false 
supportsSchemasl nT ableDefinitions true 
supportsSelectF orU pdate true 
supportsStoredP rocedures false 
supportssubqueriesl nComparisons true 
supportsSubqueriesl nE xists true 
supportsSubqueriesl ni ns true 
supportssubqueriesl nQuantifieds false 
supportsT ableCorrelationN ames true 
supportsT ransactionl solationL evel false 
TRANSACTION NONE 
supportsT ransactionl solationL evel false 
TRANSACTION READ UNCOMMITTED 
supportsT ransactionl solationL evel false 
TRANSACTION READ COMMITTED 
supportsT ransactionl solationL evel true 
TRANSACTION REPEATABLE READ 
supportsT ransactionl solationL evel false 
TRANSACTION _SERIALIZABLE 
supportsT ransactions true 
supportsU nion false 
supportsU nionAll false 
usesL ocalFilePerTable false 
usesL ocal Files false 
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SQL Keywords 


The following keywords are reserved for use by SQL Connector. If thereis existing SQL 
metatdata (tables and columns) that already use these keywords, then references to 
the metatdata must be surrounded by double quotes. If new metadata (tables and 
columns) is created, then the metadata should not use words in this list. 














































































































abort att_name audit average bed bcdfixed 
bcdflt binary bottom breakable Call carrycolumns 
center checkpoint columnno committed concat copyin 
copyout cumulative currentdate currentmoment |currenttime database 
databasename |datatype days daytime dba detail 
detailno editstring elseif enddo endif endpage 
endsection endstore endstream errorlimit exclusive exit 
fetchnumber fieldcomment fieldinfo fieldlabel filestatus fixed 
float4 float8 footsize format forms function 
getdate gettime giving groupcount groupno guide 
head header headformat heading highlighting |host 
hostfield hostparameter |hours ifnull index initpage 
initsection inout inquire intl int2 int4 
int8 isnull killdbin leave leftmargin lineno 
lowercase maximum message midnight minimum minlocks 
minutes months need none nvl oddpage 
outerjoin overwriting page pagebottom pagelength pageno 
pagetop paging panelwidth parameter presorted print 
comment 
prompt prompting protected reconfigure recordno recordtype 
recover rel_id rel_name repeatable report reportbottom 
reporttop reserving return returns rightmargin savepoint 
seconds sectionno segmentsize separation serializable |shared 
show skip skipping space spacing spreading 
start startpage startsection |status stddev store 
stream sync synonym to_char to_date to_number 
today top total truncate unbreakable uncommitted 
unsafe unset uppercase userid variance vaxday 
vaxhour vaxmidnight vaxminute vaxsecond vaxtime verify 
week weeks while width years 
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C 
renee 
JDBC Errors 


When an error occurs, the soL C-J DBC driver returns an sqliException and an error 
message. The sou C-J DBC driver gets this information from errors that are detected 
by the driver itself and from errors that are returned by soL C-DRB. 





For errors that occur within the Data Source or from data sources connected to the 
Data Source, the sou C-J DBC driver returns the message identification and the 
message text. For a list of native errors, see the table "sqimsg" in the server system 
Data Source named msgdb.dic. This table has four columns: 


msgnum integer not null 
facility char (8) not null 
msgid char (26) not null 
msgtxt char (160) not null 


The message identification and message text are the third and fourth columns. 


Error Message Syntax 

Error messages have the following format: 

sqli.sql.sqlidbException: error_message 

The error message returned by soL C-DRB is the concatenation of the message 
identification and the message text. There may be more than one error line returned. 
Example Error Messages 


If the) DBC data source is not found: 





sqli.sql.sqliDriver$sqlilnvalidPortException: Invalid port in URL: null 


If the Data Source is not found: 











sqli.sql.sqlidbException: SROP-E-DICPARSE, Can't Parse Dictionary 
File Name '../examples/xxx' 


If a table in the Data Source is not found: 





sqli.sql.sqlidbException: SROP-E-TABUND, Table empx Undefined in 
Dictionary File ../examples/demo 
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D 
SS 
JDBCPING Source Code 


// JDBC Ping Test 





import java.util.*; 
import java.sql.*; 


// 
public class jdbcping 
{ 
public static void main (String args[]) throws Exception // Throwable 
{ 
// url = arg[0], uid = 
if (args.length < 3) { 
System.out.printin (' 
} 





arg[1], pwd = arg[2] 


"Usage: jdbcping url uid pwd"); 


else { 
String url = args[0]; 
String uid = args[1]; 
String pwd = args[2]; 
try { 
Driver d = (Driver) Class.forName("sqli.sql.sqliDriver") .newInstance(); 
try { 
System.out.println ("\nConnecting to JDBC Data Source"); 
System.out.printin (" url = " + url); 
System.out.printin (" uid = " + uid); 
System.out.printin (" pwd = " + pwd); 
Connection c = DriverManager.getConnection (url, uid, pwd); 


System.out.println ("\nSuccessful Connection\n") ; 


catch (Exception e) { 
System.out.printin (e); 








catch (Exception e) 
System.out.printin (e); 
} 
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E 
nn 
JDBCJ OIN Source Code 


// JDBC Join Test 





import java.util.*; 
import java.sql.*; 


// 





public class jdbcjoin 
{ 


public static void main (String args[]) throws Exception // Throwable 
{ 

Driver d = null; 

Connection c = null; 

Statement s = null; 

ResultSet r = null; 

boolean more; 


// url = arg[0], uid = arg[1], pwd = arg[2] 

if (args.length < 3) { 
System.out.println ("Usage: jdbcjoin url user pwd"); 
System.exit (0); 
} 

String url = args[0]; 

String uid = args[1]; 

String pwd = args[2]; 


try { 
d = (Driver)Class.forName ("sqli.sql.sqliDriver") .newInstance(); 
try { 


Connection c = DriverManager.getConnection (url, uid, pwd); 
} 
catch (Exception e) { 
System.out.printin (e); 
System.exit (0); 
} 
} 
catch (Exception e) { 
System.out.println (e); 
System.exit (0); 
) 


System.out.println ("\nselect"); 

System.out.println (" dept.deptno, dept.dname, emp.empno, emp.ename, 
emp.ssno, emp.jobcls"); 

System.out.println ("from"); 

System.out.println (" dept, emp"); 

System.out.println ("where"); 

System.out.println (" dept.deptno = emp.deptno and dept.deptno < 3\n"); 
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System.out.println ("Dept.Deptno Dept.Dname Emp.Empno Emp.Ename " + 
"Emp. SSNO Emp.JobCls"); 
System.out.printin (" T) 
s = c.createStatement (); 
= s.executeQuery ("select d.deptno, d.dname, e.empno, e.ename, " + 


"e.ssno, e.jobcls from dept d, emp e " + 
"where dept.deptno = emp.deptno and dept.deptno < 3"); 
more = r.next (); 
while (more) { 
StringBuffer buf = new StringBuffer (); 








buf.append (" LS 

buf.append (getData (r, 1, 8)); 

buf.append (getData (r, 2, 13)); 

buf.append (getData (r, 3, 10)); 

buf.append (getData (r, 4, 15)); 

buf.append (getData (r, 5, 16)); 

buf.append (getData (r, 6, 7)); 

System.out.println (buf); 

more = r.next (); 

} // end fetch 
System.out.println (" Wie 
r.close (); 
s.close (); 
c.close (); 

} // end main 
// 





public static StringBuffer getData (ResultSet rs, int colNo, int outLen) 
throws Exception 
{ 
StringBuffer b = new StringBuffer (); 
b.append (rs.getString (colNo)); 
int ind = b.length(); 


if (b.length() == 0) ( 
b.append("-"); 
ind = 1; 
} 
else { 
for (int i=ind; i<outLen; i++) 
b.append(" "); 


} 


return b; 


} 


} // end class jdbcjoin 
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E 
— 
Programming Notes 





F.1 SQL Data Types 


F.1.1 SQL Double Datatype Restriction 


The maximum value of an SQL Double datatypeis 1.0e+126. TheSQL-92 documented 
maximum value is 1.797693134862316e+308. 
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